home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 096 / usbdor11.arc / USBBS.DOC < prev    next >
Text File  |  1987-07-06  |  11KB  |  397 lines

  1.  
  2.  
  3.  
  4.         --------------------------------------------------------------------
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.                                 USBBSDOR version 1.0
  21.  
  22.                                FOR RBBS-PC 15.1x DOORS
  23.  
  24.                                       for the
  25.  
  26.                         IBM Personal Computer & Compatibles
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.                                    Copyright 1987
  35.  
  36.                                          by
  37.  
  38.                                    Brent Yandell
  39.                                       Box 382
  40.                                  Freehold, NJ 07728
  41.                                DATA -- (201) 431-4088
  42.  
  43.                                    July 6th, 1987
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.         --------------------------------------------------------------------
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.         --------------------------------------------------------------------
  71.                                       USBBSDOR
  72.         --------------------------------------------------------------------
  73.  
  74.                                  TABLE OF CONTENTS                      Page
  75.                                  -----------------                      ----
  76.  
  77.         1.0   INTRODUCTION                                                 3
  78.               1.1  Before Starting                                         3
  79.               1.2  Update Conventions                                      3
  80.  
  81.         2.0   SETTING UP                                                   4
  82.               2.1  Required Files                                          4
  83.               2.2  Converting Darwin's List                                5
  84.  
  85.         3.0   RUNNING USBBSDOR                                             6
  86.               3.1  Reporting Problems                                      6
  87.               3.2  Acknowledgments                                         6
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.                                    Page 2 Of 6
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.         --------------------------------------------------------------------
  137.                                       USBBSDOR
  138.         --------------------------------------------------------------------
  139.  
  140.         1.0  INTRODUCTION
  141.         -----------------
  142.         USBBSDOR  is  a door program for RBBS-PC that allows the  caller  to
  143.         access  the  Darwin National BBS Listings as a  database,  based  on
  144.         input from the caller.  The Darwin list was selected as the database
  145.         for  this  door  because of its outstanding reputation  in  the  BBS
  146.         community.
  147.  
  148.  
  149.         1.1  Before Starting
  150.         --------------------
  151.         It is highly recommended that you read this documentation thoroughly
  152.         before  attempting  to install this door. You must have  a  copy  of
  153.         Darwin's  (latest)  listing  before using this door.  This  list  is
  154.         available  from many BBS systems around the country and  is  usually
  155.         called  USBBSxxx.ARC  where xxx is the latest version  number.  This
  156.         door  will not run properly if you have not installed / created  ALL
  157.         of the text files properly, so take your time and read thoroughly.
  158.  
  159.         1.2  Update Conventions
  160.         -----------------------
  161.         This  door will be updated as changes in RBBS-PC, the layout of  the
  162.         Darwin list, or enhancements to the door itself dictate.
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.                                    Page 3 Of 6
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.         --------------------------------------------------------------------
  203.                                       USBBSDOR
  204.         --------------------------------------------------------------------
  205.  
  206.         2.0  SETTING UP
  207.         ---------------
  208.         The  purpose  of  this documentation is to explain  to  you  how  to 
  209.         install the USBBSDOR program. It assumes that you have already  read 
  210.         the  documentation that comes with RBBS-PC (section  16)  concerning 
  211.         doors  and their use. If you are  not already  running  doors and/or 
  212.         the  explanation   of doors in RBBS-PC's  docs  is  confusing,   you 
  213.         should contact a system already running doors for assistance.
  214.  
  215.         2.1  Required Files
  216.         -------------------
  217.         The following files should be contained in USBDOR10.ARC :
  218.  
  219.         USBBS.EXE      -  The executable program file.
  220.  
  221.         USBBS.HLP      -  A  help file for when a user needs [H]elp in  the
  222.                           door.
  223.  
  224.         USBBS.PRE      -  A prelog file displayed when entering the door.
  225.  
  226.         USBBS.DEF      -  A definition file that contains information needed
  227.                           by the door program such as time allowed in door.
  228.  
  229.         USBBS.DOC      -  This documentation file.
  230.  
  231.         MAKE-LST.BAS   -  A small basic program that will take  your  current
  232.                           DARWIN list and make 3 needed files.
  233.  
  234.         The following files will be made by MAKE-LST.BAS & USBBSxxx.LST :
  235.  
  236.         USBBS.LST      -  The   Darwin  database   containing   only   the
  237.                           information on BBS listings.
  238.  
  239.         USBBS.INF      -  The header from the Darwin listing.  Gives caller
  240.                           info about Darwin.
  241.  
  242.         USBBS.SYM      -  The end  of the Darwin listing,  where the symbols
  243.                           and the abbreviations used in the list are defined.
  244.  
  245.  
  246.         The following batch file to run the door must be created by you :
  247.  
  248.         USBBS.BAT      -  Batch file to run USBBSDOR.
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.                                    Page 4 Of 6
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.         --------------------------------------------------------------------
  269.                                       USBBSDOR
  270.         --------------------------------------------------------------------
  271.  
  272.         The  file USBBS.EXE and all the files that are with this  door  must
  273.         all  run  together  on the same drive and  subdirectory.  Also,  the
  274.         MESSAGES and RBBS-PC.DEF files must also be located with these files
  275.         as  certain  info such as user name, COM port, baud,  &  parity  are
  276.         pulled from these files when entering the door.
  277.  
  278.         The  files USBBS.PRE and USBBS.HLP were left outside the program  as
  279.         text  files so that you may change them as you please  to  customize
  280.         them to suit your board.
  281.  
  282.         USBBS.DEF contains two lines. Line one is the minutes allowed in the
  283.         door, and line two is the number of times the same caller can log in
  284.         to the door each day. Change these to suit your board's needs.
  285.  
  286.         USBBSDOR creates a file called USBBS.DAY which is how the door keeps
  287.         track of how many times a caller  has accessed the door. The file is
  288.         changed on each new day  by the door, so there is  never any need to
  289.         modify or change this file. In fact, strange  results could occur if
  290.         this  file is modified. The local or remote sysop is exempt from any
  291.         limitations on  entering the door.  To log onto to the door locally,
  292.         the sysop  must have  either been  the last  person logged  onto the
  293.         board or you must have the Com port set at 0 with config.
  294.  
  295.         2.2 Converting Darwin's list
  296.         ----------------------------
  297.         You   should   put  MAKE-LST.BAS  and  USBBSxxx.LST  on   the   same
  298.         subdirectory.  Using  either BASICA or GWBASIC,  load and run  MAKE-
  299.         LST.BAS. You will be prompted for the name of the list you are going
  300.         to put through the conversion - i.e.  USBBSxxx.LST (again, where xxx
  301.         is  the current version number).  You will see the conversion as  it
  302.         progresses,  and  it could take a couple of minutes depending on the
  303.         type  of machine you are running.  When the process is complete  you
  304.         will  have  four  files...   Your  original  unchanged  version   of
  305.         USBBSxxx.LST,  and 3 new files USBBS.LST,  USBBS.INF, and USBBS.SYM.
  306.         Take  a look at these 3 new files with your favorite word  processor
  307.         or  text editor.  When a new  version of the Darwin list is released
  308.         you  may find it easier to create these files with an editor  rather
  309.         than the enclosed MAKE-LST.BAS.  (Note : If you use a word processor
  310.         for  this  task,  be certain that you use the non-document mode  and
  311.         create a normal ASCII text file so it can be properly displayed.)
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.                                    Page 5 Of 6
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.         --------------------------------------------------------------------
  335.                                       USBBSDOR
  336.         --------------------------------------------------------------------
  337.  
  338.         3.0  RUNNING USBBSDOR
  339.         ---------------------
  340.         Create the batch file USBBS.BAT ( or whatever you are going to  call 
  341.         the door ).  In most situations, this file will only need to contain 
  342.         two lines.  In the first line, turn whatever version of WATCHDOG you 
  343.         are using OFF....i.e.  WATCHDOG OFF,  or WATCHDG1 OFF. In the second
  344.         line,  all  you need to put in is the name of the executable program
  345.         you are going to run, in this case USBBS.
  346.  
  347.         To  review,  the following files MUST ALL be on the drive  and  path
  348.         where you are running doors from...
  349.  
  350.         USBBS.EXE     USBBS.LST     USBBS.INF     USBBS.BAT
  351.         USBBS.SYM     USBBS.DEF     USBBS.PRE     USBBS.HLP
  352.  
  353.         3.1  Reporting problems
  354.         -----------------------
  355.         Should  an error occur during the use of the door, a file should  be
  356.         created called USBBS.ERR with information about the error. Any error
  357.         information should be reported to the author immediately. But first,
  358.         go  through the 8 fliles listed at the end of section 3.0  and  make
  359.         certain that they are correct and all located in the correct  place.
  360.         The  most  common  errors that occur are from one of  the  necessary
  361.         files not being available to the program.
  362.  
  363.         3.2  Acknowledgments
  364.         ---------------------
  365.         Thanks to the folks of Darwin, without whose fine listing  this door
  366.         would never have come to be.
  367.         --------------------------------------------------------------------
  368.         Thanks to -            Fleet and Dawn Senseman
  369.                                      Edison, NJ
  370.                                DATA -- (201) 769-6830
  371.                          For their BETA testing of USBBSDOR.
  372.         --------------------------------------------------------------------
  373.         Thanks to -          The Staff of Tsymetryx, Ltd
  374.                                    Downingtown, PA
  375.                                DATA -- (215) 269-9592
  376.                  For their assistance in writing this documentation.
  377.         --------------------------------------------------------------------
  378.  
  379.         The latest version of USBBSDOR can be found  on either  of these two
  380.         boards or on my board, DATA -- (201) 431-4088.
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.                                    Page 6 Of 6
  392.  
  393.  
  394.  
  395.  
  396.  
  397.